home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 1 / Cream of the Crop 1.iso / UTILITY / STR22.ARJ / STR.DOC next >
Text File  |  1992-05-24  |  17KB  |  309 lines

  1.  
  2.                                 STR 2.2
  3.  
  4.                             Memory-resident
  5.                         String pasting program
  6.  
  7.                                   by
  8.                                Bob Eyer
  9.  
  10.                              May 24, 1992
  11.  
  12.                           Means of contact -
  13.                            CIS: [73230,2620]
  14.                    CRS, IBM Conference 416-629-7020
  15.                   ROSE, Main Conference 416-733-2285
  16.  
  17.                            * LOCAL RELEASE *
  18.  
  19.  
  20.      Syntax
  21.      ------
  22.  
  23.      STR [color -lines filename] [/U]
  24.  
  25.      Edit:   Ctrl-Backspace
  26.       -  ENTER selects and pastes string
  27.       -  Ctrl-Home clears all strings
  28.  
  29.      Color       A  positive  integer  determining the colour scheme of
  30.                  the edit window.  See Color Section below for details.
  31.  
  32.      -Lines      A negative integer setting the number  of  strings  to
  33.                  allocate   in   memory.   If  this  parameter  is  not
  34.                  mentioned,  STR  defaults  Lines   to   10   elements,
  35.                  corresponding to memory use of about 14K.  The maximum
  36.                  is determined by all available memory, less 100K.
  37.  
  38.                  The  user will hardly ever need to set this parameter,
  39.                  unless he wishes to read into STR all strings  from  a
  40.                  file at runtime.
  41.  
  42.      Filename    The name of the file containing a list of  strings  to
  43.                  read by STR.  Lines must be set higher than filename's
  44.                  linecount.
  45.  
  46.                  Linelength in this file is limited to the size of  the
  47.                  edit  buffer  -  55  characters.  Lines longer than 55
  48.                  will be truncated to 55 in this version.
  49.  
  50.  
  51.      Examples
  52.      --------
  53.  
  54.      STR
  55.  
  56.      sets colour to black on white, allocates 10 strings, and loads  no
  57.      input file.
  58.  
  59.      STR 27 -20
  60.  
  61.      sets  colour  to  bright cyan on blue background, allocating space
  62.      for 20 strings, loading no file list.
  63.  
  64.      STR -1000 sample
  65.  
  66.      sets  colour  to  black  on white, allocates 1000 lines, and loads
  67.      them from the file called 'sample'.
  68.  
  69.      Discussion
  70.      ----------
  71.      This program has been largely rewritten from the version posted in
  72.      SUTL22.ZIP  (Compuserve,  IBMHW  forum).   Version  2.2 has a much
  73.      larger capacity, and makes much fuller use of the cursor pad.
  74.  
  75.      In edit mode, Ctrl-Home clears all  strings,  if  desired.   Since
  76.      this  Ctrl-Home  is  INTERNAL  to  the  edit  window,  it does not
  77.      interfere with Ctrl-Home which  is  used  in  some  communications
  78.      programs.
  79.  
  80.      Typing  each string followed by the Up or Down cursors enters what
  81.      was typed into a STR array.  The number of the  entry  appears  in
  82.      the far right margin, so the user can see where he is in the array
  83.      without  obscuring underlying text excessively.  The backspace key
  84.      operates as normal, as does the DEL key and the Home,  End,  PgUp,
  85.      and PgDn keys (except that the Pg keys skip 10 lines instead of 24
  86.      or 23).
  87.  
  88.      ENTER   pastes   the  string  in  the  window  to  the  underlying
  89.      application, but does not delete it from memory.
  90.  
  91.      This   procedure  avoids  excessive  use  of  hotkeys,  which  may
  92.      short-circuit  some  special   function   keys   in   editing   or
  93.      communications applications.
  94.  
  95.      The value of this program is that it provides an auxiliary  source
  96.      of  strings  accessible  by  hotkey.  Most communications programs
  97.      provide special keys for  injecting  text  into  a  communications
  98.      session;  however,  many  users would prefer to reserve these keys
  99.      for data which is more  or  less  permanent.   STR's  strings  are
  100.      obviously  temporary,  and  are easily changed at any time without
  101.      punching through a maze of submenus.
  102.  
  103.      Color
  104.      -----
  105.      The  numbers  to  use  for  Color  are determined by the following
  106.      chart:
  107.  
  108.                   Back     Fore   Bright Fore
  109.                   ----     ----   -----------
  110.      Black           0        0    8
  111.      Blue           16        1    9
  112.      Green          32        2   10
  113.      Cyan           48        3   11
  114.      Red            64        4   12
  115.      Magenta        80        5   13
  116.      Brown          96        6   14
  117.      White         112        7   15
  118.  
  119.      Use  of  0  (black  on black) is always converted to 112 (black on
  120.      white) by STR.
  121.  
  122.      The correct COLOR number is found merely by adding the  Foreground
  123.      number  to  the  Background  number  desired.  For example, Bright
  124.      Green on Blue background is 10 + 16 = 26.
  125.  
  126.      Avoid setting COLOR above  127.   Values  above  that  limit  will
  127.      produce blinking displays.
  128.  
  129.      In  my  estimation the COLORs best for the eye are 10, 11, 14, 15,
  130.      26, 27, 30, 31, 74, 75, 78, 79 and 112.  But you  may  have  other
  131.      ideas.   Example,
  132.  
  133.      COLOR 75
  134.  
  135.      sets the window to Bright Cyan on a Red background.
  136.  
  137.  
  138. ┌──────────────────── SHAREWARE NOTICE and TERMS ──────────────────────────┐
  139. │                                                                          │
  140. │    The  content  of  this  archive  is  shareware:  if  you intend to    │
  141. │    use it more or less regularly, you must register with the author.     │
  142. │                                                                          │
  143. │    In return for your registration you will receive the  most  recent    │
  144. │    updates  of  the  items mentioned in the list below.  This benefit    │
  145. │    far  exceeds  the  value  of  the   specific   program   you   are    │
  146. │    registering.   Unlike  other  shareware agreements, this agreement    │
  147. │    entitles you to receive everything  in  the  list  below,  if  you    │
  148. │    register just one item!!                                              │
  149. │                                                                          │
  150. │    Simply purchase a money order from your bank in the amount of  $20    │
  151. │    US made out to Bob Eyer and send with your return address to:         │
  152. │                                                                          │
  153. │      Bob Eyer                                                            │
  154. │      1100 Bloor Street West                                              │
  155. │      Suite 16                                                            │
  156. │      Toronto, Canada M6H 1M8                                             │
  157. │                                                                          │
  158. │    Please mention in your accompanying note whether you wish 5.25" or    │
  159. │    3.5" diskette format,  and  state  the  name  in  which  you  wish    │
  160. │    registration-only  utilities  to  be  registered.                     │
  161. │                                                                          │
  162. │    Do not send checks.  Checks cause  problems  across  international    │
  163. │    borders  which  make  them  unsuitable for small purchases by mail    │
  164. │    order.  Checks will be returned to you with your order unfilled.      │
  165. │                                                                          │
  166. │    Enquiries may be placed by writing  directly  to  the  author  via    │
  167. │    Easyplex  at  Compuserve  [73230,2620],  or by mail to the address    │
  168. │    above.  Registered users are always assured of a response, and  of    │
  169. │    tech support related to these programs, if needed.                    │
  170. │                                                                          │
  171. │    The  author  is amenable to requests for custom versions of any of    │
  172. │    these works; terms subject to negotiation.                            │
  173. │                                                                          │
  174. │    The price of registration is very inexpensive: in return for  your    │
  175. │    basic   registration,  you  receive  some  700K  in  programs  and    │
  176. │    documentation.                                                        │
  177. │                                                                          │
  178. │                                                                          │
  179. │    Warranty and Disclaimer:                                              │
  180. │    -----------------------                                               │
  181. │    The  author,  Bob Eyer, of this and all items below guarantees the    │
  182. │    physical integrity of the diskette covering the points above,  and    │
  183. │    will  replace  free  of  charge,  if  it  is  received  defective.    │
  184. │    However, in no case will the author be responsible for any damages    │
  185. │    due to loss of data or any other reason.  In  no  event  does  the    │
  186. │    author's  liability  for any damages exceed the price paid for the    │
  187. │    buyer's order of this software, regardless  of  the  form  of  the    │
  188. │    claim.   The  person  using  the software bears all risk as to the    │
  189. │    quality and performance of the software.                              │
  190. │                                                                          │
  191. │                                                                          │
  192. │     DESCRIPTION OF PROGRAMS YOU WILL RECEIVE FOR YOUR CONTRIBUTION       │
  193. │     --------------------------------------------------------------       │
  194. │                                                                          │
  195. │    The  items listed below, except the ones with asterisk in the left    │
  196. │    margin,  are  registered  to  you   personally.    As   personally    │
  197. │    registered  to you, these particular copies may not be distributed    │
  198. │    without the author's consent.  Names of programs falling into this    │
  199. │    category are all versions of MG, versions of SPC  after  SPC  5.4,    │
  200. │    all  versions  of  HOST,  CA, KNT, and FCA.  These programs may be    │
  201. │    freely circulated only in their  'shareware'  form.   Versions  of    │
  202. │    these  programs  which  are personally registered to the user must    │
  203. │    not be so circulated.  When you place  an  order  by  making  your    │
  204. │    shareware  contribution  under  these  terms,  you are agreeing to    │
  205. │    abide by this principle.                                              │
  206. │                                                                          │
  207. │    MG 3.0                                                                │
  208. │    ------                                                                │
  209. │    Moving average ASCII graphing program.   Especially  designed  for    │
  210. │    obtaining  graphic  updates  on stock-market activity in practical    │
  211. │    trading environments, in which it is essential that the user get a    │
  212. │    quick  graph  immediately,  with  points  of  the  graph  directly    │
  213. │    associated  with  the  numerical  and other text information which    │
  214. │    these points represent (a feat  impractical  in  Lotus  graphics).    │
  215. │    Designed to be used with SETV in the SUTL package.                    │
  216. │                                                                          │
  217. │    SPC 5.5                                                               │
  218. │    -------                                                               │
  219. │    Multidrive columnar drive report, with fairly complete description    │
  220. │    of  your  machine  including  communications,   important   chips,    │
  221. │    printer,   BIOS,   memory,   processor   and   coprocessor  speed,    │
  222. │    multitasking, networking, and so on, all in one  single  snapshot.    │
  223. │    New   version   doubles   the   amount   of  information  on  each    │
  224. │    communications port and displays the information in columnar  mode    │
  225. │    above  the drive report, adds an environment usage readout as well    │
  226. │    as a new P parameter to pause the PRINT multiplexer,  when  it  is    │
  227. │    used  to  feed  data  to  your  printer.  (DOS PRINT lacks a pause    │
  228. │    command).                                                             │
  229. │                                                                          │
  230. │    HOST 2.4                                                              │
  231. │    --------                                                              │
  232. │    Provides   a   simple   BBS   host   for  occasional  use.   Fully    │
  233. │    configurable, but capable of being run 'right  out  of  the  box',    │
  234. │    HOST provides ringback, file transfer, mail, chat, userlog, shell,    │
  235. │    and  much  more  - in an executable only 30K in size.  Version 2.4    │
  236. │    adds option to  turn  off  noise  filtering,  and  facilities  for    │
  237. │    reading in the user's own list of file protocols.                     │
  238. │                                                                          │
  239. │    CA 2.4                                                                │
  240. │    ------                                                                │
  241. │    4-function  fixed point TSR calculator with formatted displays and    │
  242. │    scientific  notation  for  direct  paste  to   text.    Also   has    │
  243. │    accumulator.  Four mode groups.  About 13K of memory.                 │
  244. │                                                                          │
  245. │    FCA 2.4                                                               │
  246. │    -------                                                               │
  247. │    Memory  resident  calculator  with  formatted  displays and direct    │
  248. │    paste to text, minimum screen overlay.   29  functions,  including    │
  249. │    trig,  factorials  &  combinations,  mean  &  standard  deviation,    │
  250. │    regression  analysis,  binomial,  Poisson,  normal,  and   Student    │
  251. │    distributions.   Six  mode  groups.  FCA is the most sophisticated    │
  252. │    calculator in the business for its size.  39K of memory.              │
  253. │                                                                          │
  254. │    KNT 2.0                                                               │
  255. │    -------                                                               │
  256. │    Memory  resident Netbios-compatible keystroke counter with options    │
  257. │    for screen display and  disk  file  logging.   Great  productivity    │
  258. │    tool.  Uses about 10K of memory.                                      │
  259. │                                                                          │
  260. │                                                                          │
  261. │  * FUTL 2.0                                                              │
  262. │    --------                                                              │
  263. │    A collection of file processing  utilities  including -               │
  264. │    CHG 2.8  - File/directory attribute/date/time reader/changer          │
  265. │    ELIM 2.6 - Replacement for DOS DEL                                    │
  266. │    FVER 2.1 - BBS file list verifier - automatic, redirectable           │
  267. │    MV 2.8   - File mover, large improvement over MV 2.6.                 │
  268. │    MVA 2.1  - BBS file mover, reads from list, uses download path        │
  269. │    OTL 3.0  - Operation to List, generalisation of MVA, for BBSes        │
  270. │    RNF 2.2  - Puts special flags on filenames                            │
  271. │    SWP 2.0  - Single level sweep program, faster than SWEEP.COM          │
  272. │    TYME 2.3 - Program execution timer                                    │
  273. │    WD 2.6   - Applies wildcard to any program                            │
  274. │    Each is the best and smallest in the business for what it does.       │
  275. │                                                                          │
  276. │  * SUTL 2.3                                                              │
  277. │    --------                                                              │
  278. │    A  collection  of small utilities covering batch file, diagnostic,    │
  279. │    communications analysis, file, video, and other  areas,  including    │
  280. │    AL, CFIX, DOSV, DTR, EL, EMS, KALL, LF, STR, PAUZ, PF, PORT, RING,    │
  281. │    RTS,  SETV, SS, and TSTF.  Includes a number of very useful memory    │
  282. │    resident  programs,  such  as  AL(alarm) and PORT(analyser).  Much    │
  283. │    better version of STR.                                                │
  284. │                                                                          │
  285. │  * TUTL 2.1                                                              │
  286. │    --------                                                              │
  287. │    A collection of text-processing utilities,  including  ADD,  CBRO,    │
  288. │    CITM,  COMB,  DIV,  ESRT, LCNT, REV, and SPLT.  Except for LCNT (a    │
  289. │    very fast  wildcarded  text  linecounter),  these  programs  cover    │
  290. │    important  ground  in  text  processing  for which there exists no    │
  291. │    other alternative in the shareware  market.   Users  who  do  much    │
  292. │    work with ASCII text should not be without these utilities.           │
  293. │                                                                          │
  294. └──────────────────────────────────────────────────────────────────────────┘
  295.  
  296.      --------------------------------------
  297.      End of documentation
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.